home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / pc_board / duper141.zip / DUPER.DOC < prev    next >
Text File  |  1992-04-15  |  4KB  |  93 lines
  1.  
  2.    ╒═══════════════════════════════════════════════════════════════╕
  3.    │               ╔════                                           │
  4.    │               ║                                               │
  5.    │               ╚═══╗     ║       ║                             │
  6.    │                   ║ ║ ║ ╠═╗ ═╦═ ║                             │
  7.    │               ════╝ ╚═╣ ╚═╝ ═╩═ ╚═ WARE                       │
  8.    │                       ║  by boB Gage                          │
  9.    │                     ══╝  Available on Sybil BBS               │
  10.    │                          (703) 951-2708  300 - 2400 baud      │
  11.    │                          HST/v32bis for registered users      │
  12.    │    Duper - Duplicate Message Reporting Utility                │
  13.    ╘═══════════════════════════════════════════════════════════════╛
  14.  
  15.  
  16. Duper does not find, remove, or pack out duplicate messages.  What it
  17. does do is check your PCBPack log to find what messages were duplicates,
  18. and then your caller's logs to find out WHO left them.  One or messages
  19. are left in a conference of your choice listing the duplicate messagers.
  20.  
  21. This program was designed specifically for Jim Fouch of Sleepy Hollow
  22. BBS for use in tracking excessive duplicating nodes in U'NI-net/US.
  23.  
  24. Duper is called from the command line with NO parameters.  It assumes
  25. that PCBPack has already been run, and the caller's logs have not yet
  26. been purged.  It may take re-arranging your event slightly to get
  27. Duper to work properly.  All control of Duper is thru the
  28. configuration file, Duper.CFG.
  29.  
  30. The format for the config file (Duper.CFG name is hardcoded) is fairly
  31. relaxed.  There are 14 config variables, these must each be assigned using
  32. variable=value format (examples below).  Eight of the fourteen variables are
  33. required, they are:
  34.  
  35.    BBS=BBS name (must match registration exactly!)
  36.    REG=registration code (must match given code exactly!)
  37.  
  38.    PackLog = path & filename of PCBpack log file
  39.    CallLog = path & filename of caller logs (no node number!)
  40.    NumNodes = number of caller logs to process
  41.    MsgBase = PCB message file to post message to
  42.    MsgText = path & filename of text file containing body of msg sent by Duper
  43.    LogFile = path & filename of Duper log file
  44.  
  45. There are also six optional variables.  These are ONLY active in the
  46. registered version of Duper.  They all apply to the message sent by Duper.
  47. The defaults are listed, they will be used if either the variable is
  48. missing from the config file, or Duper is unregistered.
  49.  
  50.    MsgSubj = Subject of message          def: Duplicate Messages
  51.    MsgFrom = From field of message       def: Duper 1.4
  52.    MsgEcho = Y or N  Echo message?       def: Yes
  53.    MsgPrivate = Y or N Reciever only?    def: No
  54.    OneMsg = Y or N  Single msg style?    def: Yes
  55.  
  56. The following switches only apply if you are using the multiple message style
  57. (ie ONEMSG=N):
  58.  
  59.    MinDupes = # of dupes before sending a message         def: 1
  60.    PrivSumm = Y or N  Include sysop-only summary message  def: Y
  61.  
  62. There's a sample Duper.CFG in this packet, you can use it as a guide.
  63.  
  64. A couple things about the configuration for the message(s) left.
  65. There's two ways you can do it.
  66.  
  67.    1)  You can set it up to leave a single message to ALL with the text
  68. from the file named in line 11, followed by a blank line, and then one
  69. or more lines saying so-and-so left this many dupes.  One person per
  70. line.  The last line will have the number of "unknown source" dupes.
  71. Don't use a # in the text file, as it will be replaced with a zero.
  72.  
  73.  OR
  74.  
  75.    2) You can leave a message to each and every duper.  This message
  76. would include just the text file named in line 11.  Any occurance of #
  77. in the text file will be replaced with the number of dupes left by that
  78. caller. This scheme will leave an addition private message to SYSOP
  79. stating the number of "unknown source" dupes, unless the PrivSumm switch
  80. is set to N.
  81.  
  82. As you can see in the configuration file layout, you have full control
  83. over the message header.
  84.  
  85. Once you've modified the config file and the message text file to suit
  86. your purposes, just run Duper with no parameters.  Duper.CFG MUST be
  87. in the current directory when you run Duper.
  88.  
  89. If you have any problems, give me a call!
  90. boB Gage
  91. (703) 951-8449  300-2400 free access node
  92. (703) 953-0665  HST/v32bis Registered users only
  93.